Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Sequence Grabber Settings

SGSetChannelSettings

The SGSetChannelSettings function allows you to configure a sequence grabber channel.

pascal ComponentResult SGSetChannelSettings (SeqGrabComponent s, 
                                             SGChannel c,
                                             UserData ud, 
                                             long flags);

s

Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.

c

Identifies the channel to be configured. You provide your
connection identifier. You connect to a channel component by calling the SGNewChannel or SGNewChannelFromComponent function, discussed on page 5-29 and page 5-30, respectively.

ud

Specifies a Movie Toolbox user data list that contains the configuration information to be used by the channel component.

flags

Reserved for Apple. Set this parameter to 0.

DESCRIPTION

The SGSetChannelSettings function allows you to configure a sequence grabber channel. You provide this configuration information in a Movie Toolbox user data list. Typically, you obtain this configuration data from the SGGetChannelSettings function, which is discussed in the previous section.

RESULT CODES

noDeviceForChannel	-9400	Channel component cannot find its device
couldntGetRequiredComponent	-9405	Component not found
deviceCantMeetRequest	-9408	Device cannot support grabber

SEE ALSO

You may set the configuration of all of the sequence grabber's channels by using the SGSetSettings function. This function is described on page 5-48.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help